Configure Browser Settings from Tests

Accessing Internet Explorer Settings

Accessing Mozilla Firefox Settings

You can use the following scripting objects to control and change Internet Explorer and Microsoft WebBrowser settings:

• To access advanced settings, use the IESettings object.

  This object is returned by the Options.IESettings property. It contains Internet Explorer settings that are displayed on the Advanced page of Internet Explorer’s Internet Options dialog (this dialog is shown when you select Tools | Options from Internet Explorer’s main menu).

  For more information on available settings, see the IESettings object description.

• To access security zone settings, use the IEZoneSettingsManager object.

  This object is returned by the Options.IEZoneSettings property. It lets you access security zone settings that are displayed on the Security Settings dialog of Internet Explorer. To display the dialog, select Tools | Options from Internet Explorer’s main menu, switch to the Security page of the ensuing Internet Options dialog and press Custom Level.

  The IEZoneSettingsManager object contains two methods: GetZoneSettingsById and GetZoneSettingsByUrl. GetZoneSettingsById provides access to security settings of the zone specified by the method parameter. GetZoneSettingsByUrl detects the zone that the specified URL belongs to and then provides scripting access to the settings of this zone.

  For more information on available zone settings, see the IEZoneSettings object description.

Note that Internet Explorer’s options, which you can change via the IESettings and IEZoneSettings objects, also affect WebBrowser controls. The changes you made to object properties will also be applied to WebBrowser controls.

If you use the Mozilla Firefox browser, then to control and change its settings, you can use the special Preferences object.

This object is returned by the Preferences property of the object that corresponds to the Mozilla Firefox browser. Through this object you can access a variety of options that are shown in the Firefox browser when you enter about:config in the address bar and press Enter. For each option displayed on this page, the Preferences object has a corresponding property. The only difference is that similar properties are grouped by categories.

For example, the following code enables the "Smooth scrolling" feature from script. It is equivalent to selecting the Tools | Options | Advanced | General | Browsing | Use smooth scrolling option from the browser.

However, the approach described above does not work for the preferences whose names contain hyphens. For example, the code above will not work for the "network.automatic-ntlm-auth.trusted-uris" preference. To work with such preferences from your tests, use setBoolPref, getBoolPref, setCharPref, getCharPrefm and similar methods. The code below demonstrates the mentioned approach:

In JScript, C#Script and C++Script tests, you can also use the square bracket notation: